home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / minix / up1510b.tgz / up1510b / doc / sz.doc < prev    next >
Text File  |  1990-07-19  |  15KB  |  389 lines
  1.  
  2.  
  3.  
  4.      SZ(1)                                                SZ(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           sx, sb, sz - XMODEM, YMODEM, ZMODEM file send
  10.  
  11.      SYNOPSIS
  12.           sz [-+abdefkLlNnopqTtuvyY] file ...
  13.           sb [-adfkqtuv] file ...
  14.           sx [-akqtuv] file
  15.           sz [-oqtv] -c COMMAND
  16.           sz [-oqtv] -i COMMAND
  17.           sz -TT
  18.  
  19.      DESCRIPTION
  20.           Sz uses the ZMODEM, YMODEM or XMODEM error correcting
  21.           protocol to send one or more files over a dial-in serial
  22.           port to a variety of programs running under PC-DOS, CP/M,
  23.           Unix, VMS, and other operating systems.
  24.  
  25.           While rz is smart enough to be called from cu(1), very few
  26.           versions of cu(1) are smart enough to allow sz to work
  27.           properly.  Unix flavors of Professional-YAM are available
  28.           for such dial-out application.
  29.  
  30.  
  31.           Sz sends one or more files with ZMODEM protocol.
  32.  
  33.           ZMODEM greatly simplifies file transfers compared to XMODEM.
  34.           In addition to a friendly user interface, ZMODEM provides
  35.           Personal Computer and other users an efficient, accurate,
  36.           and robust file transfer method.
  37.  
  38.           ZMODEM provides complete END-TO-END data integrity between
  39.           application programs.  ZMODEM's 32 bit CRC catches errors
  40.           that sneak into even the most advanced networks.
  41.  
  42.           Advanced file management features include AutoDownload
  43.           (Automatic file Download initiated without user
  44.           intervention), Display of individual and total file lengths
  45.           and transmission time estimates, Crash Recovery, selective
  46.           file transfers, and preservation of exact file date and
  47.           length.
  48.  
  49.           Output from another program may be piped to sz for
  50.           transmission by denoting standard input with "-":
  51.                                   ls -l | sz -
  52.           The program output is transmitted with the filename sPID.sz
  53.           where PID is the process ID of the sz program.  If the
  54.           environment variable ONAME is set, that is used instead.  In
  55.           this case, the Unix command:
  56.                            ls -l | ONAME=con sz -ay -
  57.           will send a "file" to the PC-DOS console display.  The -y
  58.           option instructs the receiver to open the file for writing
  59.           unconditionally.  The -a option causes the receiver to
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/18/89)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SZ(1)                                                SZ(1)
  71.  
  72.  
  73.  
  74.           convert Unix newlines to PC-DOS carriage returns and
  75.           linefeeds.
  76.  
  77.  
  78.           Sb batch sends one or more files with YMODEM or ZMODEM
  79.           protocol.  The initial ZMODEM initialization is not sent.
  80.           When requested by the receiver, sb supports YMODEM-g with
  81.           "cbreak" tty mode, XON/XOFF flow control, and interrupt
  82.           character set to CAN (^X).  YMODEM-g (Professional-YAM g
  83.           option) increases throughput over error free channels
  84.           (direct connection, X.PC, etc.)  by not acknowledging each
  85.           transmitted sector.
  86.  
  87.           On Unix systems, additional information about the file is
  88.           transmitted.  If the receiving program uses this
  89.           information, the transmitted file length controls the exact
  90.           number of bytes written to the output dataset, and the
  91.           modify time and file mode are set accordingly.
  92.  
  93.  
  94.           Sx sends a single file with XMODEM or XMODEM-1k protocol
  95.           (sometimes incorrectly called "ymodem").  The user must
  96.           supply the file name to both sending and receiving programs.
  97.  
  98.           Iff sz is invoked with $SHELL set and iff that variable
  99.           contains the string rsh or rksh (restricted shell), sz
  100.           operates in restricted mode.  Restricted mode restricts
  101.           pathnames to the current directory and PUBDIR (usually
  102.           /usr/spool/uucppublic) and/or subdirectories thereof.
  103.  
  104.  
  105.           The fourth form sends a single COMMAND to a ZMODEM receiver
  106.           for execution.  Sz exits with the COMMAND return value.  If
  107.           COMMAND includes spaces or characters special to the shell,
  108.           it must be quoted.
  109.  
  110.  
  111.           The fifth form sends a single COMMAND to a ZMODEM receiver
  112.           for execution.  Sz exits as soon as the receiver has
  113.           correctly received the command, before it is executed.
  114.  
  115.  
  116.           The sixth form (sz -TT) attempts to output all 256 code
  117.           combinations to the terminal.  In you are having difficulty
  118.           sending files, this command lets you see which character
  119.           codes are being eaten by the operating system.
  120.  
  121.  
  122.           If sz is invoked with stdout and stderr to different
  123.           datasets, Verbose is set to 2, causing frame by frame
  124.           progress reports to stderr.  This may be disabled with the q
  125.           option.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/18/89)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SZ(1)                                                SZ(1)
  137.  
  138.  
  139.  
  140.           The meanings of the available options are:
  141.  
  142.  
  143.           +    Instruct the receiver to append transmitted data to an
  144.                existing file (ZMODEM only).
  145.           a    Convert NL characters in the transmitted file to CR/LF.
  146.                This is done by the sender for XMODEM and YMODEM, by
  147.                the receiver for ZMODEM.
  148.           b    (ZMODEM) Binary override: transfer file without any
  149.                translation.
  150.           c COMMAND
  151.                Send COMMAND to the receiver for execution, return with
  152.                COMMAND's exit status.
  153.           d    Change all instances of "." to "/" in the transmitted
  154.                pathname.  Thus, C.omenB0000 (which is unacceptable to
  155.                MSDOS or CP/M) is transmitted as C/omenB0000.  If the
  156.                resultant filename has more than 8 characters in the
  157.                stem, a "." is inserted to allow a total of eleven.
  158.           e    Escape all control characters; normally XON, XOFF, DLE,
  159.                CR-@-CR, and Ctrl-X are escaped.
  160.           f    Send Full pathname.  Normally directory prefixes are
  161.                stripped from the transmitted filename.
  162.           i COMMAND
  163.                Send COMMAND to the receiver for execution, return
  164.                Immediately upon the receiving program's successful
  165.                recption of the command.
  166.           k    (XMODEM/YMODEM) Send files using 1024 byte blocks
  167.                rather than the default 128 byte blocks.  1024 byte
  168.                packets speed file transfers at high bit rates.
  169.                (ZMODEM streams the data for the best possible
  170.                throughput.)
  171.           L N  Use ZMODEM sub-packets of length N.  A larger N (32 <=
  172.                N <= 1024) gives slightly higher throughput, a smaller
  173.                N speeds error recovery.  The default is 128 below 300
  174.                baud, 256 above 300 baud, or 1024 above 2400 baud.
  175.           l N  Wait for the receiver to acknowledge correct data every
  176.                N (32 <= N <= 1024) characters.  This may be used to
  177.                avoid network overrun when XOFF flow control is
  178.                lacking.
  179.           n    (ZMODEM) Send each file if destination file does not
  180.                exist.  Overwrite destination file if source file is
  181.                newer than the destination file.
  182.           N    (ZMODEM) Send each file if destination file does not
  183.                exist.  Overwrite destination file if source file is
  184.                newer or longer than the destination file.
  185.           o    (ZMODEM) Disable automatic selection of 32 bit CRC.
  186.           p    (ZMODEM) Protect existing destination files by skipping
  187.                transfer if the destination file exists.
  188.           q    Quiet suppresses verbosity.
  189.           r    (ZMODEM) Resume interrupted file transfer.  If the
  190.                source file is longer than the destination file, the
  191.  
  192.  
  193.  
  194.      Page 3                                          (printed 4/18/89)
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      SZ(1)                                                SZ(1)
  202.  
  203.  
  204.  
  205.                transfer commences at the offset in the source file
  206.                that equals the length of the destination file.
  207.           t tim
  208.